API Compatibility

Requests to PTV Drive&Arrive

• could have new optional parameters
• new parameters are optional and have a default value
• removed parameters will be ignored if send to the API

Responses of PTV Drive&Arrive

• removing of already existing parameters PTV Drive&Arrive is forbidden
• new parameters are allowed (must be ignored by old clients)
• new “enum” values are not allowed

In general:

• No changes are allowed in data type of existing parameters

How can API users reach compatibility using enums?

• Calling PTV Drive&Arrive API with C# enums must be implemented using Enum.TryParse<TEnum> method

Functionality marked as experimental

• These are new functions still under development. They may be changed without prior notice.